home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / COMMS / NTALK.ZIP / ReadMe
Text File  |  1998-01-20  |  7KB  |  181 lines
  1.  
  2.  
  3.                                 UnixTalk
  4.  
  5.                            Version 0.06 beta
  6.  
  7.                               - Freeware -
  8.  
  9.                 (C) Marco Baye & Istvan Horvath 1997, 1998
  10.  
  11.  0. Copyright
  12.  
  13.   The UnixTalk and TalkIO applications are (C) Marco Baye & Istvan Horvath.
  14.   Both applications are released as freeware, which means that you may copy and
  15. distribute them.
  16.  
  17.   If you distribute them, you must distribute the archive in its original form,
  18. without modifying any of its files. You are not allowed to make money with
  19. these programs, you may only charge to cover the cost of distributing them.
  20.  
  21.   UnixTalk uses the ntalk protocol, but no part of it is based on the original
  22. BSD "talk" / "ntalk" / "talkd" / "ntalkd" sources.
  23.   TalkIO uses ZapRedraw, (C) Dominic Symes 1994. Thanks to Dominic for
  24. permitting us to use it.
  25.  
  26.   These programs are supplied "as is". The authors don't accept any
  27. responsibility for loss of data or other damage resulting from the use of
  28. UnixTalk and/or TalkIO.
  29.  
  30.   If you are unsure about these terms, please contact the authors (see below).
  31.  
  32.  
  33.  1. Contents
  34.  
  35.   0.    Copyright
  36.   1.    Contents
  37.   2.    Introduction
  38.    2.1    Basic
  39.    2.2    Features
  40.    2.3    Version
  41.   3.    Installation
  42.   4.    Basic use
  43.    4.1    Sending talk requests
  44.    4.2    Receiving talk requests
  45.    4.3    Logout
  46.    4.4    The Hotlist
  47.   5.    Misc
  48.   6.    Contacting the authors
  49.  
  50.  
  51.  2. Introduction
  52.  
  53.   2.1 Basic:
  54.  
  55.     UnixTalk implements the "ntalk" protocol used under Unix to allow a
  56. conversation between users. Under BSD Unix, a user can request a connection to
  57. another user by typing "talk <username>@<hostname>". The recipient will be
  58. informed and if he/she accepts the connection by issueing a matching command,
  59. both users can see what the other one is typing. For this to work, ntalk
  60. daemons (servers) and clients have to be installed on both systems.
  61.     Because RISC OS is a single-user system, the client and the server don't
  62. have to be separate programs.
  63.     Therefore, UnixTalk acts as both a client and a server. The actual chat
  64. sessions are then handled by the separate application TalkIO, which is started
  65. as a subtask when needed. Several TalkIO's can (and will) run concurrently if
  66. needed, sharing their resources and therefore cutting down on memory usage.
  67.     UnixTalk should run on any TCP/IP stack that supports the Acorn sockets
  68. interface.
  69.  
  70.   2.2 Features:
  71.  
  72.     Sending of outgoing talk requests.
  73.     Announce windows for incoming talk requests.
  74.     A hotlist for connections that are used often.
  75.     The ability to reject all incoming talk requests while showing them on-
  76. screen with a datestamp (useful if you leave the computer for a while).
  77.     If your chat partner uses these programs as well, an extended chat protocol
  78. is used, which lets you use the cursor keys, for example.
  79.  
  80.   2.3 Version:
  81.  
  82.     UnixTalk is at version 0.06 beta. It is written in Basic, but the assembler
  83. version will hopefully be finished in a few days time.
  84.     TalkIO is at version 0.96 beta. Is is written in Assembler.
  85.  
  86.  
  87.  3. Installation
  88.  
  89.   If you want to start using UnixTalk right away, the first thing you should do
  90. is this:
  91.   Shift-doubleclick the UnixTalk icon to open its directory, then double-click
  92. the "Hotlist" file. Edit the line starting with "root" to contain your desired
  93. login name instead - your real name or IRC nickname, for example. Save the
  94. hotlist file before starting UnixTalk. This should be done because sending talk
  95. requests as "root" will surely irritate the recipient of the talk request.
  96.  
  97.  
  98.  4. Basic use
  99.  
  100.   4.1 Sending talk requests
  101.  
  102.     To send a talk request, click SELECT on the UnixTalk icon bar icon (on the
  103. left hand side of the icon bar). You can also do this by choosing "Send
  104. request…" from UnixTalk's icon bar menu.
  105.     A window will open, named "Send Talk request".
  106.     The "As:" field in the upper left corner contains your own login name. This
  107. will be displayed to your party when your request is announced.
  108.     The "To:" field is for typing in the login name of the user you want to
  109. chat with.
  110.     The "@" field is for typing in the hostname of your party's machine.
  111.     Press the "Cancel" button to make the window disappear, or press the "Send"
  112. button to send your talk request.
  113.     If you click on the "Add to Hotlist" button, the login and hostname fields
  114. will be saved to your hotlist.
  115.  
  116.   4.2 Receiving talk requests
  117.  
  118.     When somebody else is sending you a talk request, a window named "Incoming
  119. Talk request" will pop up in the middle of your screen, containing the address
  120. of the sender (Click "Add to Hotlist" to save this address to your hotlist). If
  121. you click on "Accept", UnixTalk will open a "Send Talk request" window to check
  122. for the connection. When the connection is established, the dialogue windows
  123. will disappear and a chat window will open.
  124.  
  125.   4.3 Logout
  126.  
  127.     If you leave the computer for a while, it would be nice if UnixTalk would
  128. reject all incoming talk requests and make a note of it to show to you later
  129. on. Well, it can do that. :)
  130.     Just click ADJUST on the icon bar icon, or choose "Logged in" from the icon
  131. bar menu. The menu item and the icon bar icon will reflect the change. When you
  132. are marked as being "not logged in", all incoming talk requests are rejected
  133. (the sender will see "Your party is not logged on"). No "Incoming Talk request"
  134. windows will pop up. Instead, a similar window will appear, which shows the
  135. time when it was created. When you return to the computer, you can try to talk
  136. back to the person who sent the talk request by clicking on "Try to talk back".
  137.  
  138.   4.4 The Hotlist
  139.  
  140.     UnixTalk has basic hotlist functions. To send a talk request to an address
  141. from your hotlist, open the icon bar menu and choose the address from the
  142. submenu "Hotlist". Only the login name is shown, though this can be changed. If
  143. you start the !Help application, it will show the full address.
  144.     In the send, announce and note windows there is a button called "Add to
  145. hotlist", which will save the displayed address to your hotlist. It will be
  146. appended to the file and to the menu immediately.
  147.  
  148.     After you have manually edited the hotlist file (recommended because the
  149. user's login name isn't always the best thing to display), the only way to make
  150. UnixTalk re-load the file is to quit and restart UnixTalk. I will try to change
  151. this in the future, so that UnixTalk uses the ExternalEdit or OLE protocol.
  152.  
  153.  
  154.  5. Misc
  155.  
  156.   Though the current version of UnixTalk is written in Basic, it places a very
  157. low load on the computer, because it polls the wimp only once per second.
  158.  
  159.   Please don't complain about the use of the toolbox modules; I really don't
  160. want to build menus on my own ever again.
  161.  
  162.   And don't tell me that the sprite sucks, I know it does. :)
  163.   If you can paint a more appealing one, don't hesitate to send it to me - I
  164. would really appreciate it.
  165.  
  166.   Both applications are StrongARM-compatible.
  167.  
  168.  
  169.  6. Contacting the authors
  170.  
  171.   The newest versions of UnixTalk and TalkIO can be found at the UnixTalk homepage:
  172.   http://home.pages.de/~mac_bacon/ntalk/
  173.  
  174.   If you want to report a bug or make a suggestion, then simply drop us an
  175. email.
  176.   (Or send a talk request :)
  177.  
  178.   mailto:Istvan.Horvath@tu-clausthal.de (TalkIO)
  179.   mailto:Marco.Baye@tu-clausthal.de (UnixTalk)
  180.   talkto:Marco@dionin.esw-heim.tu-clausthal.de
  181.